package com.distribute.framework.dao;

import java.util.List;
import java.util.Map;

import com.distribute.framework.core.util.Function;
import com.distribute.framework.core.web.util.Page;
import com.distribute.framework.model.TbThreeCity;

/**
 * 三级城市的Dao接口
 * @author 刘代应
 */
@SuppressWarnings("unchecked")
public interface ITbThreeCityDao
{
	/**
	 * 获取所有三级城市
	 * @return
	 */
	public List<TbThreeCity> getTbThreeCityList(Map params,Integer offset,Integer size);

	/**
	 * 获取三级城市统计
	 * @return
	 */
	public List getTbThreeCityStats(Map params,Map<String,Object> groups,Map<String,Object> sums);

	/**
	 * 获取三级城市总数
	 * @return
	 */	
	public Long getTbThreeCityCount(Map params);
	
	/**
	 * 获取三级城市自定义求和表达式,比如求和:eval="sum(id)"
	 * @return
	 */	
	public <T> T getTbThreeCityEval(String eval,Map params);
	
	/**
	 * 获取三级城市分页
	 * @return
	 */	
	public Page getTbThreeCityPage(int page,int size,Map params);
	
	/**
	 * 根据查询条件取三级城市
	 * @param params
	 * @return
	 */
	public TbThreeCity getTbThreeCity(Map params);	

	/**
	 * 根据ID取三级城市
	 * @param id
	 * @return
	 */
	public TbThreeCity getTbThreeCityById(Long id);


	
	

	/**
	 * 保存三级城市
	 * @param tbThreeCity
	 */
	public TbThreeCity saveTbThreeCity(TbThreeCity tbThreeCity);

	/**
	 * 更新三级城市
	 * @param tbThreeCity
	 */
	public int updateTbThreeCity(TbThreeCity tbThreeCity);
	/**
	 * 更新三级城市非空字段
	 * @param tbThreeCity
	 */
	public int updateTbThreeCity$NotNull(TbThreeCity tbThreeCity);

	/**
	 * 根据ID删除一个三级城市
	 * @param id
	 */
	public void deleteTbThreeCityById(Long id);
	
	/**
	 * 根据ID逻辑删除一个三级城市
	 * @param id
	 */
	public void removeTbThreeCityById(Long id);
	
	/**
	 * 根据条件更新三级城市
	 * @param values
	 * @param params
	 */
	public int updateTbThreeCityByConfirm(Map values, Map params);
	/**
	 * 根据条件删除三级城市
	 * @param params
	 */
	public void deleteTbThreeCityByConfirm(Map params);
	
	/**
	 * 执行过程，以便事务回滚
	 * @param function
	 */
	public <T> T executeTransaction(Function function);

}